Skip to content

Add agent-skills-setup: offline migration, backup and restore for Agent Skills, rules and MCP - #2866

Open
Luckycat133 wants to merge 1 commit into
github:mainfrom
Luckycat133:add/agent-skills-setup
Open

Add agent-skills-setup: offline migration, backup and restore for Agent Skills, rules and MCP#2866
Luckycat133 wants to merge 1 commit into
github:mainfrom
Luckycat133:add/agent-skills-setup

Conversation

@Luckycat133

@Luckycat133 Luckycat133 commented Aug 30, 2026

Copy link
Copy Markdown

What this adds

skills/agent-skills-setup (v0.9.2) — an offline, previewed, rollback-safe migrator for AI-coding-agent context, plus one row in docs/README.skills.md. No workflow or repository-infrastructure files are touched.

What the skill does

  • Migrate Skills, instructions/rules (CLAUDE.md, .cursorrules, …) and local stdio MCP configs across Cursor, Claude Code, Codex, Cline, Copilot, Windsurf, Gemini CLI and other supported profiles — including cross-device backup/restore via signed, checksum-verified Agent Context Bundles (ACB).
  • Preview-first: every write goes through a reviewed plan (plan → apply --yes → verify → rollback); nothing is written without explicit consent.
  • Secret-safe: strict secret scanning; literal credentials are rejected or redacted to environment-variable references before anything is copied. Trust state, raw chat history, tokens and generated memory are never moved.
  • Honest boundaries: remote (HTTP/SSE) MCP, prompts, commands, agents and hooks emit manual reconstruction checklists instead of being auto-written. Plugin package copy and session handoff only travel behind explicit --include-plugins / --include-session opt-in flags, enforced fail-closed at the apply layer.

Notes for maintainers

  • This is a clean resubmission of the previously closed Add agent-skills-setup: cross-IDE AI assistant context migration #2388 (that PR was against the old repo location and v0.5.0, and included unrelated changes). This PR is rebased on current main, contains only skills/agent-skills-setup/** and the docs/README.skills.md row, and reflects the real v0.9.2 capability boundary.
  • MIT licensed; bundled assets are under the 5MB-per-file limit (largest is the migration engine at ~180KB; the demo GIF is 82KB).
  • Offline by design: the skill performs no network calls; gh skills install github/awesome-copilot agent-skills-setup works as listed in the table row.

@Luckycat133
Add agent-skills-setup: offline migration, backup and restore for Age…
b2c21b2 
…nt Skills, rules and MCP

Adds skills/agent-skills-setup (v0.9.2) and its entry in docs/README.skills.md. Offline, previewed, rollback-safe migration of Skills, instructions/rules and local stdio MCP across Cursor, Claude Code, Codex, Cline, Copilot, Windsurf, Gemini CLI and other supported profiles, including cross-device backup/restore via signed ACB bundles. Secrets are redacted or rejected; plugins and session handoff only travel behind explicit opt-in flags.
@github-actions github-actions Bot added the skills PR touches skills label Aug 30, 2026
@github-actions

github-actions Bot commented Aug 30, 2026

Copy link
Copy Markdown
Contributor

🔒 PR Risk Scan Results

Scanned 179 changed file(s).

Severity Count
🔴 High 0
🟠 Medium 383
ℹ️ Info 72
Severity Rule File Line Match
🟠 package-exec-command skills/agent-skills-setup/agent-skills-setup/evals/files/cursor-project-mcp.json 4 "command": "npx",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 3 "global_skills": "~/.gemini/config/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 6 "mcp": "~/.gemini/config/mcp_config.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 11 "global_skills": "~/.claude/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 14 "mcp": "~/.claude.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 17 "config": "~/.claude/settings.json"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 20 "global_skills": "~/.codely-cli/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 23 "mcp": "~/.codely-cli/settings.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 26 "config": "~/.codely-cli/settings.json"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 29 "global_skills": "~/.agents/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 32 "mcp": "~/.codex/config.toml",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 35 "config": "~/.codex/config.toml"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 38 "global_skills": "~/.copilot/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 41 "mcp": "~/.copilot/mcp-config.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 46 "global_skills": "~/.cursor/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 49 "mcp": "~/.cursor/mcp.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 54 "global_skills": "~/.codeium/windsurf/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 57 "mcp": "~/.codeium/windsurf/mcp_config.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 61 "global_skills": "~/.junie/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 64 "mcp": "~/.junie/mcp/mcp.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 69 "global_skills": "~/.openclaw/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 72 "mcp": "~/.openclaw/openclaw.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 73 "config": "~/.openclaw/openclaw.json"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 76 "global_skills": "~/.trae/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 84 "global_skills": "~/.trae-cn/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 92 "global_skills": "~/.copilot/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 100 "global_skills": "~/.copilot/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 128 "global_skills": "~/.agents/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 136 "global_skills": "~/.agents/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 139 "mcp": "~/.config/zed/settings.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 148 "config": "~/.config/nvim/init.lua"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 161 "mcp": "~/.continue/config.yaml",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 163 "config": "~/.continue/config.yaml"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 170 "config": "~/.aider.conf.yml"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 173 "global_skills": "~/.roo/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 182 "global_skills": "~/.cline/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 185 "mcp": "~/.cline/data/settings/cline_mcp_settings.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 193 "mcp": "~/.aws/amazonq/default.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 215 "mcp": "~/.tabnine/mcp_servers.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 258 "global_skills": "~/.gemini/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 261 "mcp": "~/.gemini/settings.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 264 "config": "~/.gemini/settings.json"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 267 "global_skills": "~/.agents/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 270 "mcp": "~/.config/goose/config.yaml",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 271 "config": "~/.config/goose/config.yaml"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 274 "global_skills": "~/.config/opencode/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 277 "mcp": "~/.config/opencode/opencode.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 280 "config": "~/.config/opencode/opencode.json"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 284 "global_skills": "~/.kilo/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 287 "mcp": "~/.config/kilo/kilo.jsonc",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 290 "config": "~/.config/kilo/kilo.jsonc"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 293 "global_skills": "~/.kimi-code/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 296 "mcp": "~/.kimi-code/mcp.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 298 "config": "~/.kimi-code/config.toml"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 304 "mcp": "~/.workbuddy/mcp.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 313 "darwin": "~/Library/Application Support/Claude/claude_desktop_config.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 320 "global_skills": "~/.kiro/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 323 "mcp": "~/.kiro/settings/mcp.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 328 "global_skills": "~/.augment/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 331 "mcp": "~/.augment/settings.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 334 "config": "~/.augment/settings.json"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 340 "mcp": "~/.void-editor/mcp.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 345 "global_skills": "~/.comate/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 348 "mcp": "~/.comate/mcp.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 353 "global_skills": "~/.codebuddy/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 356 "mcp": "~/.codebuddy/.mcp.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 359 "config": "~/.codebuddy/settings.json"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 362 "global_skills": "~/.zcode/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 365 "mcp": "~/.zcode/cli/config.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/ide-paths.json 368 "config": "~/.zcode/cli/config.json"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 130 "path": "~/.aws/amazonq/cli-agents",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 150 "path": "~/.aws/amazonq/agents",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 190 "path": "~/.aws/amazonq/default.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 239 "path": "~/.augment/rules",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 253 "path": "~/.augment/user-guidelines.md",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 262 "path": "~/.augment/settings.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 285 "path": "~/.augment/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 349 "darwin": "~/.claude/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 350 "linux": "~/.claude/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 351 "wsl": "~/.claude/skills"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 371 "path": "~/.claude.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 380 "path": "~/.claude/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 424 "darwin": "~/.claude",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 425 "linux": "~/.claude",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 426 "wsl": "~/.claude"
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 444 "path": "~/.claude.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 453 "path": "~/.claude/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 518 "darwin": "~/.cline/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 519 "linux": "~/.cline/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 534 "path": "~/.cline/agents",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 550 "path": "~/.cline/cron",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 565 "path": "~/.cline/data",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 574 "path": "~/.cline/hooks",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 593 "path": "~/.cline/rules",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 614 "path": "~/.cline/data/settings/cline_mcp_settings.json",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 630 "path": "~/.cline/plugins",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 646 "path": "~/.cline/skills",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 662 "path": "~/.cline/data/workflows",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 702 "darwin": "~/.cline",
🟠 unpinned-version-indicator skills/agent-skills-setup/agent-skills-setup/references/registry-v2.json 703 "linux": "~/.cline",

355 additional finding(s) omitted from table.

Skipped non-text or missing files
  • skills/agent-skills-setup/agent-skills-setup/assets/demo.gif

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

@github-actions

github-actions Bot commented Aug 30, 2026

Copy link
Copy Markdown
Contributor

🔍 Vally Lint Results

✅ All checks passed

Scope Checked
Skills 1
Agents 0
Total 1
Severity Count
❌ Errors 0
⚠️ Warnings 0
ℹ️ Advisories 0

Summary

Level Finding
ℹ️ ✅ agent-skills-setup (2/2 checks passed)
ℹ️ ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
ℹ️ ✓ spec-compliance: All spec checks passed.
ℹ️ ✓ [valid-refs] All file references across 1 skill(s) are valid.
ℹ️ ✓ valid-refs: All file references resolve to existing files within the skill directory.
ℹ️ 1 skill(s) linted, 1 passed
Full linter output 
### Linting skills/agent-skills-setup
✅ agent-skills-setup (2/2 checks passed)
    ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
        ✓ spec-compliance: All spec checks passed.
    ✓ [valid-refs] All file references across 1 skill(s) are valid.
        ✓ valid-refs: All file references resolve to existing files within the skill directory.

1 skill(s) linted, 1 passed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@aaronpowell aaronpowell Awaiting requested review from aaronpowell aaronpowell is a code owner

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

skills PR touches skills

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@Luckycat133